home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / p / portfoli / dfue / tmxm2 / tmxm2.doc < prev    next >
Encoding:
Text File  |  1996-10-30  |  4.8 KB  |  108 lines
  1. TMXM2.COM - The second generation Terminal with XModem and
  2. Text File Transfer for the Atari/DIP Portfolio.
  3.  
  4. by Jim Straus                            November 24, 1989
  5. (c) 1989 by Jim Straus                    All rights reserved
  6. Certain portions of the code are (c) 1989 by Atari and DIP.
  7.  
  8. If you are using this program and you find it to be of value,
  9. your contribution ($20 suggested) will be appreciated.
  10.     Jim Straus
  11.     3826 Mumford Place
  12.     Palo Alto, CA 94306
  13. You are encouraged to copy and share this program and docu-
  14. mentation with other users, on the condition that they are
  15. not distributed in modified or incomplete form, that no fee
  16. or consideration is charged and that this notice is not
  17. bypassed or removed.
  18.  
  19. No warranty is given or implied for this programming system.
  20. In no event shall the author of this work be liable for any
  21. direct, indirect, special, incidental, or consequential
  22. damages (including lost profit) whether based on warranty,
  23. contract, tort, or any other legal theory.
  24.  
  25. Whew!  This program will only work on the Atari/DIP Portfolio
  26. PalmTop computer.  It is a simple terminal program for the
  27. Serial Interface.  It  allows files to be sent or received
  28. using the XModem protocol.  It also allows files to be sent
  29. with no translation and files to be captured.
  30.  
  31. To use the program, select serial port parameters from the
  32. built-in Setup program.  The Initialize! command does not
  33. need to be given as the program will attempt to initialize
  34. the serial port itself.  You may also want to set the External
  35. Display to Tracked (80x25).  Then start the program by typing
  36. TMXM at the DIP-DOS prompt.  You will see a greeting, and
  37. anything you type is sent out the serial port.  F1 may be used
  38. to exit the program (Note that the Atari key also generates an
  39. F1 key code).
  40.  
  41. During the session, F2 may be used to start receiving a file
  42. using the XModem protocol.  You will be prompted for a file
  43. name, and then the program will wait for the file to be
  44. transferred.  Each block successfully received will cause a
  45. period to be displayed.  When the file is done, "Done" will
  46. be displayed and you will be back in the terminal portion.
  47. While the program is transferring, the F1 key may be used to
  48. abort the transfer.
  49.  
  50. Sending a file is started with the F3 key and proceeds in a
  51. similar fashion.  If the file was not found, you will just see
  52. "Done" displayed.
  53.  
  54. Note that XModem always transfers files in 128 byte blocks,
  55. so files will tend to be rounded up to the nearest 128 byte
  56. length.  When receiving text files, you may also see extra
  57. space on the end, depending on whether or not the sending end
  58. put in a Control-Z terminating character.  TMXM does not put
  59. in such characters and just pads with zeros.
  60.  
  61. The XModem time out values in this program have not been
  62. tested with a packet network (such as that used by Compuserve),
  63. but have been adjusted to Compuserve's suggested values.
  64.  
  65. Capturing text is controlled with the SHIFT-F2 key.  The first
  66. time it is pressed, you will be prompted for a file name.  From
  67. then on anything received is also saved in the file.  To stop
  68. capturing, use the SHIFT-F2 key again.  It will tell you it is
  69. "Done".  Text may be captured through XModem transfers and text
  70. sending, but only received text that is displayed will be saved
  71. in the capture file.
  72.  
  73. SHIFT-F3 is used to send a text file.  It prompts for a file
  74. name and the file is sent.  When the file is done, you will
  75. again see "Done".
  76.  
  77. As an experimental feature, TMXM2 will also take command line
  78. options.  The two forms are:
  79.     TMXM2 -r filename
  80.     TMXM2 -s filename
  81. The -r option will enter the XModem receive state, and when it
  82. is done receiving the file, the program will exit.  The -s
  83. option enters the XModem send state.
  84.  
  85. The reason for putting these in, was to try and come up with
  86. a semi-automatic method to back up the Portfolio through the
  87. serial port.  In my case, to a Macintosh running the Red
  88. Ryder (tm of FreeSoft Inc.) terminal program.  On the Portfolio
  89. I have a BACKUP.BAT file that looks like:
  90.     echo RECX filename.txt>aux
  91.     tmxm2 -s filename.txt
  92. with the above lines repeated for each file to be backed up.
  93. Red Ryder is left in HOST mode, so the above sequence should
  94. automatically send FILENAME.TXT to the Macintosh.  A similar
  95. process is used to restore the files:
  96.     echo SENDX filename.txt>aux
  97.     tmxm2 -r filename.txt
  98.  
  99. The above sequences have not been thoroughly tested.  There
  100. may still be some timing problems in them (I occasionally hang
  101. restoring.  It can be alleviated by stopping the transfer on
  102. the Macintosh and sending two Control-Xs to cancel that file).
  103. This is not considered a final solution, but I thought people
  104. might be interested.  Others might want to try build scripts
  105. to drive other host machine terminal programs too.
  106.  
  107. The length of the file is 2431 bytes and the checksum (as
  108. determined by CHKSUM.COM) is FC6D.